PATHMac OS 8 Developer Documentation > Human Interface Toolbox > Control Manager >

Programming With the Mac OS 8.5 Control Manager

RemoveControlProperty

Removes a piece of data that has been previously associated with a control.

pascal OSStatus RemoveControlProperty (
                     ControlHandle control,
                     OSType propertyCreator,
                     OSType propertyTag);
control
A value of type ControlHandle . Pass a handle to the control whose associated data you wish to remove.
propertyCreator
A four-character code. Pass your program's signature, as registered through Apple Developer Technical Support. If your program is of a type that would not normally have a signature (for example, a plug-in), you should still register and use a signature in this case, even though your program's file may not have the same creator code as the signature that you register. The 'macs' property signature is reserved for the system and should not be used.
propertyTag
A four-character code. Pass the application-defined code identifying the associated data.
function result
A result code. See Result Codes for the Mac OS 8.5 Control Manager .

DISCUSSION

Your application may dissociate data it has previously set with the SetControlProperty function by calling the RemoveControlProperty function.


VERSION NOTES

Available with Mac OS 8.5 and later.


SEE ALSO

The function GetControlProperty .

© 1999 Apple Computer, Inc. — (Last Updated 20 Jan 99)